home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / mac / files / hf_utils / beam110.exe / READ.ME < prev    next >
Text File  |  1993-07-21  |  16KB  |  438 lines

  1. BEAM Antenna direction Program
  2.  
  3. Please help us out by sending us your comments on this program!
  4.  
  5. Did it work on your computer?
  6. Were any error messages encountered?
  7. Does your computer have an incompatible graphics adapter? Which one?
  8. Did you observe any prefix or location errors?
  9. How can we make it easier to use?
  10. Did you like what you saw?
  11.  
  12. What additional features would you like to see in the next version?
  13.  
  14. Please send your comments by email to Peter Jennings:
  15.  
  16. CompuServe:      72470,3171
  17. Internet:        72470.3171@compuserve.com
  18. Fido Netmail:    1:216/506
  19. Snailmail:       JCI Shareware, Box 336B, Ben Lomond, CA 95005 USA
  20.  
  21. This program is distributed as shareware.  It may not be sold for more
  22. than the copying cost without the written permission of the author.
  23. If you would like to register your copy, please send any amount you
  24. feel appropriate to JCI Shareware.  All payments received will be donated
  25. to Handi-Hams to provide amateur radio equipment to the handicapped.
  26. VISA and MasterCard donations may be sent via email.  No amount is too
  27. much (or too little). Your generosity will be much appreciated.
  28.  
  29. ______________________________________________________________________
  30.  
  31. BEAM    A World Map Beam Heading Program          by Peter Jennings
  32.  
  33. (c) 1993 Jennings Communications, Inc.
  34.  
  35. BEAM shows a color map of the world on VGA monitors.  If you have
  36. a mouse, you can use it to move the destination cursor to the
  37. target location.  If not, the arrow keys can be used.
  38.  
  39. Features
  40. ========
  41. Mercator projection world map.
  42. Continental US map with states.
  43. Automatic plotting by amateur callsign, latitude/longitude, postal zip code.
  44. Plotting of points from keyboard, mouse selection, or file.
  45. Distance and bearing shown from user's station.
  46. Antenna relocation using mouse.
  47. Grid square display based on Zip code or location.
  48. County lookup based on Zip code.
  49. Address lookup from HamBase with location, County, Grid Square display.
  50. Random location display.
  51. Save screen as a GIF file with title for distribution.
  52.  
  53. QUICK DEMO
  54. ==========
  55.  
  56. To run BEAM with the station in Las Vegas, just type DEMO and press Enter.
  57.  
  58.         C:HAM> DEMO    [Enter]
  59.  
  60. Press Enter at all the prompts to accept the default values.
  61.  
  62. Plot the demo file using the Alt-F command.
  63.  
  64.      Call:  Alt-F
  65.      File:  DEMO    [Enter]
  66.  
  67. Use Alt-H to see what else is available.  Don't forget to come back here
  68. and read the READ.ME file for more information.
  69.  
  70. -------------------------------------------------------------------------
  71.  
  72. MANUAL
  73. ======
  74. To run BEAM, just type BEAM and press Enter.
  75.  
  76.         C:HAM> BEAM    [Enter]
  77.  
  78. To skip the antenna location prompt, the antenna location may be entered
  79. on the command line.
  80.  
  81.         C:HAM> BEAM 37.1N 122.1W    [Enter]
  82.  
  83. If you wish to default to the US map instead of the World map, add /US
  84. to the command line.
  85.  
  86.        C:HAM> BEAM 37.1N 122.1W /US
  87.  
  88. I suggest you create a BAT file to run BEAM with your station location.
  89.  
  90.         C:HAM> COPY CON MAP.BAT
  91.         C:\HAM\BEAM 37.1N 122.1W /US
  92.         ctl-Z  [Enter]
  93.  
  94.         C:HAM> MAP
  95.  
  96. Typing MAP will run BEAM with the antenna located at 37.1°N 122.1°W.
  97. The N and W are optional. Use S and E for south and east. Negative
  98. values may also be used. If you copy MAP.BAT to any directory
  99. included in your PATH statement, you will be able to type MAP
  100. anywhere to run BEAM.  The example assumes that BEAM and its files
  101. are in the directory HAM.  Your directory name may differ.
  102.  
  103. The program will load the data files containing the prefix allocations
  104. and country locations.  These are a superset of the DXCC countries list.
  105. Some of the larger countries which use prefixes to indicate geographic
  106. location have been broken down to provide more accurate station locations.
  107.  
  108. For more information on the various data files and accessing HamBase
  109. data files, see the DATA FILES section below.
  110.  
  111. After loading, a mercator projection of the map of the world will be
  112. displayed.  Random locations will be shown and the beam will turn to
  113. point in the correct direction.  Press any key to continue.
  114.  
  115. MOUSE
  116.  
  117. The mouse is only enabled in the Call and Latitude modes.  If you are
  118. in File mode, the mouse will not put junk on the map accidentally. It
  119. is assumed you may want to save or print the resulting map.
  120.  
  121. Moving the target location with the mouse or the arrow keys will show
  122. the closest prefix in the database on the map.  The name of that location
  123. will be displayed.  The beam heading and distance to the cursor will also
  124. be displayed along with the latitude and longitude.
  125.  
  126. Pressing the left mouse button will relocate the beam to the current
  127. cursor location.
  128.  
  129. Pressing the right mouse button will place a "map tack" at the cursor
  130. location.
  131.  
  132. Note that the closest prefix is not necessarily the same as the country
  133. you are pointing at.  The colors on the map are not taken into
  134. consideration when finding the closest location in the database.
  135.  
  136. If you do not have a mouse, the up/down/right/left arrows can be used
  137. to move the cursor around the screen, but you cannot place the beam at
  138. a new location, or place manual map tacks. If there are requests for
  139. keyboard entry of these features, we will add them to a later version.
  140.  
  141. -----------------------------------------------------------------------
  142.  
  143. ALT COMMANDS
  144.  
  145. Alt-H
  146.  
  147. Display a Help screen for quick reference to the Alt keys. Press
  148. the [space] bar for a second screen.  Enter the desired Alt command
  149. for immediate execution.
  150.  
  151. Alt-C
  152.  
  153. This is the default mode.  The "Call:" prompt will be displayed.
  154. Enter any callsign.  The prefix will be decoded into a location
  155. which will be shown on the map.  The exact antenna bearing, distance,
  156. and latitude and longitude will be shown on the screen.
  157.  
  158. Zip codes may also be entered at the "Call:" prompt.  Any 5 digit
  159. number is considered to be a zip code.
  160.  
  161. Long path is not shown in this version.  For long path, always add
  162. 180°.  The long path distance is 24,876 miles minus the short path
  163. distance.  If you would like to see the long path direction and
  164. distance added to the display, please let me know.
  165.  
  166.  
  167. Alt-Z
  168.  
  169. The ZIP command allows zip codes to be entered.  There is no difference
  170. between Alt-C and Alt-Z except that the prompt is changed. In both
  171. cases, zip codes and callsigns may be entered.
  172.  
  173. Zip codes must be exactly 5 digits long.
  174.  
  175.  
  176. Alt-L
  177.  
  178. To enter an exact target location, press Alt-L. The "Latitude:"
  179. prompt will be shown.  Enter the latitude in decimal form. Many
  180. atlases will show latitude in degrees, minutes, and seconds. There
  181. are 60 minutes in 1 degree, and 60 seconds in 1 minute.  To convert
  182. minutes to decimal, divide the minutes by 60 and the seconds by
  183. 3600.  For example: 36°09'36" would be 36.0 + 9/60 + 36/3600 = 36.16°
  184. For locations south of the equator, add S to the value or use a
  185. negative number.  N is optional for northern latitudes.
  186.  
  187.          37.0        These are all valid latitudes.
  188.          38N
  189.          45 S
  190.          -12.7
  191.  
  192. At the "Longitude:" prompt, enter the longitude in degrees West. For
  193. longitudes EAST, enter a negative value, or append E to the value.
  194.  
  195.            122
  196.            122W       These are all valid longitudes.
  197.            -75
  198.            75 E
  199.  
  200. Alt-B
  201.  
  202. Alt-B (BEAM) will hide the beam if it is visible or show the beam
  203. if it is hidden.  The color of the word "Beam" on the prompt line
  204. will change according to whether the beam is shown or hidden.
  205.  
  206. Pressing the left mouse button will move the beam to a new location
  207. and show it if it is hidden.
  208.  
  209.  
  210. Alt-T
  211.  
  212. TACK COLOR.  This command lets you specify the color of the map tacks
  213. that are placed with the right mouse button.  Use the PgUp and PgDn
  214. keys to select the desired color, or type the color you wish to use.
  215.  
  216. If you type an invalid color, RED will be used.
  217.  
  218.  
  219. Alt-R
  220.  
  221. This command will show random prefixes on the map.
  222.  
  223. + will increase the display speed.
  224. - will decrease the display speed.
  225.  
  226. Press any other key to stop the random display and enter a new command.
  227.  
  228.  
  229. Alt-F
  230.  
  231. The File command is used to stick "map tacks" in locations on
  232. the map.  The file can be a ham radio log file of callsigns, a
  233. list of latitudes and longitudes with a legend, or a list of
  234. zip codes.
  235.  
  236. File:
  237. Enter the file name of the file you wish to plot on the map.  If the
  238. file is not in the current directory, enter the complete path name.
  239.  
  240. Keep Legend [Y/N]?
  241. Normally, the legend (prefix for ham files) is displayed as the point
  242. is plotted and then removed.  This prevents clutter when there are
  243. large numbers of data points.  If you only have a few points, you
  244. can keep the legends on the map.
  245.  
  246. Map Tack Color: RED
  247. The default map tacks are red.  If you want to use a different color
  248. map tack, you can type the new color at this prompt.  It is easier to
  249. use the PgUp and PgDn commands to make sure that you select a valid
  250. color.  If you select an invalid color name, RED will be used.
  251.  
  252. By changing colors, you can plot several files to the map for comparison.
  253. If a tack is already placed in a point, a second tack will not be placed.
  254. Maybe later I will create 2 colored tacks for this occurence.
  255.  
  256. While files are being plotted, the beam is hidden.  It will reappear
  257. if you change to Callsign or Latitude mode and move the mouse.
  258.  
  259. The plotting speed can be adjusted with the + and - keys.
  260.  
  261. + will increase the display speed.
  262. - will decrease the display speed.
  263.  
  264. If the speed is increased past a certain point, the sound will be disabled.
  265.  
  266. Callsign File Format:
  267. Each line of the input file must begin with a callsign.  The call
  268. must be terminated with a space, comma, or tab character. It doesn't
  269. matter what else is on each line. Maximum line length is 256 characters.
  270.  
  271. K1EA's CT program can export an ascii file of your entire contest log.
  272. These files are in the form *.ASC and can be read by the BEAM program
  273. directly.  It is interesting to watch the plotting of the stations you
  274. worked in chronological order as the propagation shifts.
  275.  
  276. Location File Format:
  277. Each line must contain a latitude ( positive = North ), a longitude
  278. ( positive = West ), and a legend of up to 32 characters.  The fields
  279. may be separated by spaces, commas, or tabs.  Leading spaces are
  280. ignored.
  281.  
  282. Callsigns and latitude/longitude records can be mixed in the same file.
  283.  
  284. The DEMO file is included as an example of a location file.
  285.  
  286. Zip Code File Format:
  287. Each line must begin with a 5 digit zip code.  To be recognized as a
  288. zip code, there must be no spaces or other characters before the numbers,
  289. and there must be exactly 5 digits followed by a space, comma, tab, or
  290. end of line.
  291.  
  292.  
  293. Alt-G
  294.  
  295. This command is used to save the map as a GIF file.  After loading
  296. a log or other file with Alt-F, it is possible to create a snapshot
  297. for later viewing with CSHOW, VPIC, etc., or to use the resultant GIF
  298. for printing or importing to a page layout program.
  299.  
  300. You will be prompted for a title which will be placed at the bottom of the
  301. saved GIF file.
  302.  
  303. As the GIF is created, the line number being converted is displayed.
  304. About 400 lines are saved in the GIF.  Please be patient.  As the GIF
  305. is created, the line number being worked on is displayed.
  306.  
  307. There are many commercial and shareware GIF viewers available. Some of
  308. these programs can be used to print the GIF.
  309.  
  310.  
  311. Alt-U
  312.  
  313. The USA command is used to load a clean copy of the US map.
  314.  
  315.  
  316. Alt-W
  317.  
  318. The WORLD command is used to load a clean copy of the world map.
  319.  
  320.  
  321. Alt-S
  322.  
  323. The SOUND command will toggle the sounds associated with placing
  324. map tacks and painting the maps.  When the sounds are turned on,
  325. a happy beep is heard.  When the sounds are turned off, a dull buzz
  326. is signalled.
  327.  
  328.  
  329. Alt-M
  330.  
  331. MOUSE DELAY.  It was discovered that one of our laptops was unable
  332. to keep up with updating the closest country while moving the mouse,
  333. resulting in a jerky mouse response.  If you find that your mouse
  334. is misbehaving when the World Map is displayed, try increasing the
  335. mouse delay.  The default value is 0.  Enter any positive number
  336. for an increased delay time before updating the screen.  50 was
  337. a good value for our laptop.  PLEASE send me an email message if
  338. you find this necessary and let me know what value was best for
  339. your computer!  This is the kind of feedback that can only come
  340. from users of different speed machines with different display and
  341. mouse drivers.
  342.  
  343. Alt-X
  344.  
  345. This command will exit the BEAM program and return you to DOS.
  346. Pressing any key during the commercial will exit immediately.
  347.  
  348. ---------------------------------------------------------------------
  349.  
  350. DATA FILES
  351.  
  352. The 3 files PREFIX.A, PREFIX.B, and READ.ME must be located in the
  353. same directory as the BEAM.EXE program file.
  354.  
  355. To decode a callsign into a location, the program looks first in
  356. PREFIX.B to find the prefix in column 0.  This gives the program
  357. a "standard" location prefix to use to look up the latitude and
  358. longitude in PREFIX.A.
  359.  
  360. The PREFIX.A file contains unique prefixes and locations sorted in
  361. alphabetical order.  To add a new location, put a unique prefix in
  362. the correct sequence into this file.  The latitude, longitude, and
  363. location name are in fixed column format.
  364.  
  365. All of the locations in the PREFIX.A file are plotted on the world
  366. map as blue dots.
  367.  
  368. The PREFIX.B file is used to decode prefixes to the unique prefix
  369. list of PREFIX.A.  New prefix allocations or unique calls can be
  370. placed in this file with the appropriate "standard" prefix as
  371. found in the PREFIX.A file.  My thanks to K2MM for his assistance
  372. in producing the PREFIX.B file.
  373.  
  374. The files ZLL.DAT and HBCOUNTY.A are HamBase files.  If you purchase
  375. HamBase in the future, you will probably receive new copies of these
  376. files which have been updated. The files provided with this program
  377. are the current versions of the ZLL.DAT and HBCOUNTY.A file. They may be
  378. installed in the same directory as BEAM.EXE, or they may be in
  379. the directory used for HamBase.  If they are in the HamBase directory,
  380. the environmental variable HAMPATH must be set to indicate the
  381. path so that the BEAM program can find the files.
  382.  
  383.      SET HAMPATH=c:\HAMBASE
  384.  
  385. It is normal to insert this line into your AUTOEXEC.BAT file so that
  386. HamBase and BEAM will be able to find the necessary files.
  387.  
  388. HB92.MAP is the map file for your HamBase data. In versions 2.xx of
  389. HamBase, this file is created with the GENMAP program.  With version
  390. 3.xx HamBase, it is necessary to generate this file with the
  391. GENERATE DATA MAP command.  See page 25 of the HamBase manual.
  392. ^^^^^^^^^^^^^^^^^
  393.  
  394. BEAM will work with all versions of the HamBase data provided the
  395. HB92.MAP file has been created properly for the appropriate version.
  396.  
  397. BEAM only accesses the basic HAMBASE data files.  It does not look
  398. in UPDATE or HBTEXT or HBNEW files for updates created by the user
  399. or not integrated into the data with the UPDATE program (version 3.xx
  400. only).
  401.  
  402. The latest HamBase data is available from j∙Com, 793 Canning Pkwy,
  403. Victor, NY 14564.  Phone (716) 924-0422, Fax (716) 924-4555 for the
  404. latest catalog.
  405. --------------------------------------------------------------------
  406. Notes
  407.  
  408. A question mark is appended to the Grid Square designator when the
  409. location is on the edge of the square.  In this case, it is equally
  410. likely that the real location is in the adjacent square due to
  411. inaccuracies in zip code to lat/long data.
  412.  
  413.  
  414. The DEMO file is an example of a data file that can be plotted using
  415. all of the various data forms in one file. A tiny amount of HamBase
  416. data has been included in HB92.MAP and HAMBASE.A so you can see how
  417. BEAM works with HamBase.  The only calls included in the HAMBASE file
  418. are the ones that appear in the DEMO file.
  419.  
  420. ----------------------------------------------------------------------
  421.  
  422. The latest version of BEAM will be available on the Mountain Retreat
  423. BBS: (408) 335-4595 in the HomeBase files area.  It may be FREQ'd from
  424. 1:216/506 with the magic name BEAM.
  425.  
  426. The latest version will also be available on CompuServe in HamNet Lib 6.
  427. ______________________________________________________________________
  428.  
  429. 73
  430. Peter Jennings
  431.  
  432. CIS:          72470,3171
  433. Internet:     72470.3171@compuserve.com
  434. Fido Netmail: 1:216/506
  435. Snailmail:    JCI Shareware, Box 336B, Ben Lomond, CA 95005 USA
  436.  
  437.  
  438.